<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
  <head>
    <title>Portecle: How to import a key pair</title>
    <link rel="stylesheet" href="help.css" type="text/css">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  </head>

  <body>

    <h1>How to import a key pair</h1>
    <hr>

    <p>
      To import a key pair into a keystore from a PKCS #12 keystore or PEM
      bundle file:
    </p>

    <ol>
      <li>From the <b>Tools</b> menu, choose <b>Import Key Pair</b>.
        Alternatively click on the <b>Import Key Pair</b> toolbar
        button:<br><img src="importkeypair.gif" alt="Import key pair icon"
                        width="16" height="16"></li>

      <li>The <b>Choose Key Pair File for Import</b> dialog will
        appear.</li>

      <li>Select the folder where the required PKCS #12 or PEM bundle file is stored.</li>

      <li>Click on the required PKCS #12 or PEM bundle file or type the filename
        into the <b>File Name</b> text box.</li>

      <li>Click on the <b>Choose</b> button.</li>

      <li>If the selected file was a PEM bundle containing encrypted private
        keys, one or more <b>Password for Private Key <em>X</em></b> dialogs
        will appear, one fore each such key.  Enter the private key password
        into the dialog and press <b>OK</b>.</li>

      <li>If the selected file was not a PEM bundle containing key pairs,
        the <b>PKCS #12 Keystore Password</b> dialog will appear. Enter the
        PKCS #12 keystore's password into the dialog and press <b>OK</b>.</li>

      <li>The <b>Import Key Pair</b> dialog will appear populated with the
        aliases of all key pairs present in the loaded PKCS #12 keystore or
        PEM bundle.</li>

      <li>When you select a key pair its algorithm will be displayed.  You
        may also view each key pair's certificate details by pressing the
        <b>Certificate Details</b> button.</li>

      <li>Select the required key pair and press the <b>Import</b> button.</li>

      <li>The <b>Key Pair Entry Alias</b> dialog will appear.</li>

      <li>Enter the alias of the new key pair and press <b>OK</b>.</li>

      <li>If the current keystore type is not <b>PKCS #12</b>:
        <ul>
          <li>The <b>Key Pair Entry Password</b> dialog will be displayed.</li>
          <li>Enter the key entry's password into the dialog and press
            <b>OK</b>.</li>
        </ul>
      </li>

      <li>The new key pair entry will appear in the keystore entries table
      with the chosen alias.</li>
    </ol>

    <p>
      <b>Shortcut key:</b> Ctrl-K.
    </p>

    <hr>
  </body>
</html>
